home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / comm / bbs / ChkAmCD101.lha / ChkCD.doc next >
Text File  |  1996-09-07  |  3KB  |  99 lines
  1.  
  2. ChkCD.rexx
  3. ==============
  4. This program is public domain & carries no warranty
  5.  
  6. Requirements: A device named CD0
  7.               rexxmast to be running
  8.               An aminet CD to check
  9.  
  10. The check will not work properly with the first Aminet CD, due to
  11. there being no TREE file on this CD.
  12.  
  13. Bugfix:  This release ensures that rexxsupport.library is loaded, which is
  14. needed for the delete() function.
  15.  
  16.  
  17. Purpose
  18. --------
  19. This program was written primarily for sysops of bulletin boards who carry
  20. online CDs.  It is quite usual to find that the published list of CD
  21. directories - as shown in TREE - contains a number of directory names which
  22. are not on the CD.  They are in fact directories which are on aminet sites,
  23. but no files from these dirs were included on the CD.
  24.  
  25. Additionally, it is not uncommon to find files listed in INDEX which were
  26. not in fact included on the CD.
  27.  
  28. While such "extras" are not troublesome they can be an irritation to BBS
  29. sysops, and to callers who select a directory only to find that it either
  30. doesn't exist or is empty.
  31.  
  32. ChkCD produces a list of all missing or empty CD directories, and of
  33. missing files.  The list appears on your CLI window and can also be copied
  34. to a file if you use the 'f' argument.
  35.  
  36. This arexx program has 2 phases:
  37.  
  38. 1. It scans CD0:aminet/TREE, and checks that all directories
  39.    listed in TREE exist on the CD, and are not empty.
  40.  
  41. 2. It scans CD0:aminet/INDEX, and checks that all directories
  42.    and files listed in INDEX do in fact exist.
  43.  
  44. Missing files or directories, and empty directories are reported on screen.
  45. If argument 'f' is supplied, the report is also written to RAM:CDcheck.
  46. e.g.  rx ChkCD f
  47.  
  48. After the run, it is up to the user what he/she does with the report.  On
  49. my own BBS I carry the INDEX and TREE on my hard drive, and they are used
  50. to control a CD acccess utility for callers.  I delete from the directory
  51. list on my hard drive any empty or missing directory names:  and from the
  52. index I remove missing filenames.
  53.  
  54.  
  55. Usage
  56. ------
  57.  
  58. 1. Load the Aminet CD in drive CD0:
  59.  
  60. 2. From a shell window:   rx ChkCD [f/?]
  61.  
  62.      (argument f causes report to be copied to file ram:CDcheck)   
  63.      (argument ? only displays purpose of program)
  64.  
  65. 3. Results appear on your shell window, and also on a text file if
  66.    option f was used.
  67.  
  68. The program may be stopped at any time with Ctrl-C.
  69.  
  70.  
  71. The future
  72. ----------
  73. If there is a demand, I will consider rewriting this program in C for much
  74. improved speed.  But since aminet CDs only come out every 2 months, a
  75. little time spent waiting for ChkCD to run is not a heavy penalty.
  76.  
  77. Bugs?
  78. -------
  79. Please report problems to me at Fidonet 2:2500/167.15
  80. Or email me on gnome@martinac.demon.co.uk
  81.  
  82. But first check reported errors carefully. Here's an interesting one
  83. from the 2nd Aminet CD:
  84.  
  85.    File comm/fido/PFreq1_0_lha does not exist
  86.  
  87. ...but surely that file DOES exist? No, not as named above. What does
  88. exist is comm/fido/PFreq1_0.lha, so look closer at the .lha extension!
  89.  
  90. ---------------------------------------------------------
  91.  
  92. Author:  Gnome (John Marchant)   Fidonet: 2:2500/167.15
  93.          Moonlight BBS, Bedford UK. +44 1234 212752
  94.             Open 6pm to 8am ONLY, including weekends.
  95.             Fax, netmail & Freq accepted during open hours.
  96.             Closed when sysop is away, or during lightning storms.
  97.  
  98.  
  99.